package org.dromara.demo.mapper;

import com.baomidou.mybatisplus.core.conditions.Wrapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.core.toolkit.Constants;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import org.apache.ibatis.annotations.Param;
import org.dromara.common.mybatis.annotation.DataColumn;
import org.dromara.common.mybatis.annotation.DataPermission;
import org.dromara.common.mybatis.core.mapper.BaseMapperPlus;
import org.dromara.demo.domain.TestDemo;
import org.dromara.demo.domain.vo.TestDemoVo;

import java.util.Collection;
import java.util.List;


/**
 * @Author 刘武贵
 * @Date 2024/8/15 22:00
 * @Description 功能描述：测试单表Mapper接口
 */
public interface TestDemoMapper extends BaseMapperPlus<TestDemo, TestDemoVo> {

    /**
     * 根据部门名称和用户名称进行数据权限控制，获取自定义分页列表
     * 该方法对分页查询结果应用了数据权限过滤，只返回用户有权限访问的数据
     *
     * @param page 分页参数，用于控制分页行为
     * @param wrapper 查询条件封装对象，用于动态拼接SQL查询条件
     * @return 返回包含分页数据的TestDemoVo对象列表
     */
    @DataPermission({
        @DataColumn(key = "deptName", value = "dept_id"),
        @DataColumn(key = "userName", value = "user_id")
    })
    Page<TestDemoVo> customPageList(@Param("page") Page<TestDemo> page, @Param("ew") Wrapper<TestDemo> wrapper);

    /**
     * 根据部门名称和用户名称进行数据权限控制，获取分页列表
     * 该方法对分页查询结果应用了数据权限过滤，只返回用户有权限访问的数据
     *
     * @param page 分页对象，用于控制分页行为和返回分页信息
     * @param queryWrapper 查询封装对象，用于动态拼接SQL查询条件
     * @return 返回包含分页数据的TestDemo对象列表
     */
    @Override
    @DataPermission({
        @DataColumn(key = "deptName", value = "dept_id"),
        @DataColumn(key = "userName", value = "user_id")
    })
    List<TestDemo> selectList(IPage<TestDemo> page, @Param(Constants.WRAPPER) Wrapper<TestDemo> queryWrapper);

    /**
     * 根据部门名称和用户名称进行数据权限控制，查询列表
     * 该方法对查询结果应用了数据权限过滤，只返回用户有权限访问的数据
     *
     * @param queryWrapper 查询封装对象，用于动态拼接SQL查询条件
     * @return 返回符合查询条件的TestDemo对象列表
     */
    @Override
    @DataPermission({
        @DataColumn(key = "deptName", value = "dept_id"),
        @DataColumn(key = "userName", value = "user_id")
    })
    List<TestDemo> selectList(@Param(Constants.WRAPPER) Wrapper<TestDemo> queryWrapper);

    /**
     * 更新实体对象，根据部门名称和用户名称进行数据权限控制
     * 该方法在更新数据时应用了数据权限控制，确保只有更新权限范围内的数据
     *
     * @param entity 待更新的实体对象
     * @return 返回更新操作影响的行数
     */
    @Override
    @DataPermission({
        @DataColumn(key = "deptName", value = "dept_id"),
        @DataColumn(key = "userName", value = "user_id")
    })
    int updateById(@Param(Constants.ENTITY) TestDemo entity);


    /**
     * 根据集合中的ID删除数据，根据部门名称和用户名称进行数据权限控制
     * 该方法在删除数据时应用了数据权限控制，确保只删除权限范围内的数据
     *
     * @param idList 待删除数据的ID集合
     * @return 返回删除操作影响的行数
     */
    @Override
    @DataPermission({
        @DataColumn(key = "deptName", value = "dept_id"),
        @DataColumn(key = "userName", value = "user_id")
    })
    int deleteByIds(@Param(Constants.COLL) Collection<?> idList);
}
